From: Eli Zaretskii <eliz@gnu.org>
Date: Sun, 30 Mar 2025 16:27:22 +0000 (+0300)
Subject: ; Improve the documentation of 'slice' display spec (bug#77384).
X-Git-Tag: archive/raspbian/1%30.2+1-2+rpi1^2~2^2~24^2~166
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https://%22Program/%22http:/www.example.com/cgi/%22https:/%22Program?a=commitdiff_plain;h=38fec86281efd78af24cc435307d55a00223db49;p=emacs.git

; Improve the documentation of 'slice' display spec (bug#77384).
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 95b17032a74..3426e764e17 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -5603,12 +5603,20 @@ instead of the text that has the display specification.
 
 @item (slice @var{x} @var{y} @var{width} @var{height})
 This specification together with @code{image} specifies a @dfn{slice}
-(a partial area) of the image to display.  The elements @var{y} and
-@var{x} specify the top left corner of the slice, within the image;
-@var{width} and @var{height} specify the width and height of the
-slice.  Integers are numbers of pixels.  A floating-point number
-in the range 0.0--1.0 stands for that fraction of the width or height
-of the entire image.
+(a partial area) of the image to display.  More precisely, the
+specification should have the following form:
+
+@lisp
+ ((slice @var{x} @var{y} @var{width} @var{height}) @var{image-desc})
+@end lisp
+
+@noindent
+where @var{image-desc} is an image descriptor described above.  The
+elements @var{x} and @var{y} specify the top left corner of the slice,
+within the image; @var{width} and @var{height} specify the width and
+height of the slice.  Integers are numbers of pixels.  A floating-point
+number in the range 0.0--1.0 stands for that fraction of the width or
+height of the entire image.
 
 @item ((margin nil) @var{string})
 A display specification of this form means to display @var{string}